home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / ENGINEER / 0804.ZIP / PLATHELP.MAN < prev    next >
Text File  |  1987-10-11  |  26KB  |  524 lines

  1.                            PLATCHECK VERSION 1.7
  2.  
  3.                                    MANUAL
  4.  
  5.  
  6.                              USER SUPPORTED SOFTWARE
  7.  
  8.            The program, PLATCHEK, is being distributed under the "Freeware"
  9.       concept under which an individual or  firm  using  this  program  and
  10.       finding  it  of  value  will voluntarily compensate the writer of the
  11.       program.
  12.  
  13.            Users are encouraged to copy this program and give it to  others
  14.       for  their  use.
  15.  
  16.            If  you find that this program has value to you,  a contribution
  17.       of $35 would be appreciated.  Upon receipt of your contribution,  you
  18.       will  become  a  registered  owner  of  PLATCHEK.   Registered owners
  19.       will  receive  notifications of upgrades of the program   which  they
  20.       will be eligible to receive at nominal cost.
  21.  
  22.  
  23.            The author of the program is  R. H. Holstein, III  of Batesburg,
  24.       S.   C.,   a  career real estate appraiser and former employee of the
  25.       Federal Land Bank System.  His experience in real  estate  appraisals
  26.       prompted  his  writing  software  capable  of  speedily  and reliably
  27.       checking land  descriptions  by  surveyor's  plats  and  courses  and
  28.       distances.
  29.  
  30.                                HOLSTEIN APPRAISALS
  31.                                P O BOX 7
  32.                                BATESBURG,  S.  C. 29006
  33.  
  34.  
  35.  ------------------------------------------------------------------------------
  36. ~
  37.  
  38.                         FILES ON DISTRIBUTION DISKETTE
  39.  
  40.  
  41.             The following files should be on the distribution diskette:
  42.  
  43.        PLATCHK7.COM is the executable file containing the PLATCHEK program.
  44.        By  entering  the  command  "PLATCHK7" at the DOS prompt the program
  45.        will be begun.
  46.  
  47.        ARC.COM is an  executable  file  which calculates the area within an
  48.        arc for use in conjunction with PLATCHEK.
  49.  
  50.        PLATHELP.MAN is the text file containing the  manual  for  operating
  51.        PLATCHEK.
  52.  
  53.        PLTWRITE.COM  is  the  executable  file which prints the manual.  By
  54.        entering the  command  "PLTWRITE"  at  the  DOS  prompt  the  entire
  55.        PLATCHEK manual will be printed.  The manual contains 12 letter size
  56.        pages.
  57.  
  58.        PLATHELP.MSG  is a help file that is used to display instructions on
  59.        the screen during the operation of the program.
  60.  
  61.  
  62.                     OTHER FILES ASSOCIATED WITH PLATCHEK
  63.  
  64.  
  65.        PRINTER.DTA is a text file used to store printer  commands.  It  can
  66.        be  altered  to provide programming for different printers.  It does
  67.        not matter if PRINTER.DTA is not on the distribution  diskette.   If
  68.        it is absent, PLATCHEK will create one with the commands for an  IBM
  69.        ProPrinter.  The operator can change the commands to the specificat-
  70.        ions of his or her printer if change is needed.   The commands  from
  71.        this file are read into memory when the program is begun.
  72.  
  73.  
  74.        XXXXXXXX.PLT  are  files of plats created by PLATCHEK at the command
  75.        of the operator.
  76.  
  77. ~
  78.  
  79.                                  GETTING STARTED
  80.  
  81.                                Clockwise Direction
  82.  
  83.            It  is  essential  that  from  the  starting point all lines are
  84.        reported in a clockwise direction.  The  location  of  the  starting
  85.        point  does  not matter.  Sometimes plats are encountered which give
  86.        their directions in a counter-clockwise direction;  these calls must
  87.        be reversed.  For example, if a plat is traveling counter-clockwise,
  88.        NW direction must be changed to  SE,  NE  to  SW,  and  vice  versa.
  89.        Sometimes  this situation is encountered with one or more lines of a
  90.        plat which for no  apparent  reason  is  reported  as  the  backward
  91.        direction  of  all  other  lines;  i.  e.,  is  going in a different
  92.        direction by 180 degrees.  In subdivision plats this is often  found
  93.        as  the  line  call  on  adjacent  lots  while  clockwise for one is
  94.        counter-clockwise for the other.
  95.  
  96.  
  97.                                   Graphics Mode
  98.  
  99.             The operating system must be in the graphics mode to  reproduce
  100.        the  computer  generated plat.  This can be accomplished by entering
  101.        the command, "GRAPHICS" at the DOS level.
  102.  
  103.             The opening screen will  provide  a  menu  with  the  following
  104.        options:
  105.  
  106.              1.  Begin New Plat.  To enter the survey data for checking the
  107.                  first time.
  108.  
  109.              2.  Instructions.  To  review  instructions  for operating the
  110.                  program.
  111.  
  112.              3.  Manage Files.  To load, save, delete, or list plat files.
  113.  
  114.              4.  Manage Printer.  To tailor print  commands  to  individual
  115.                  printers.
  116.  
  117.              5.  Exit.  To return to DOS.
  118.  
  119.  
  120.  -----------------------------------------------------------------------------
  121. ~
  122.                                  BEGIN NEW PLAT
  123.  
  124.             The  first screen upon entering this procedure asks whether the
  125.        plat to be checked reports angles to seconds.  If the  plat  reports
  126.        degrees,  minutes, and seconds for angles, the proper response would
  127.        be "Y".  If the plat only reports degrees and  minutes,  the  answer
  128.        would  be  "N".  If  "Y"  is  the answer,  a screen will appear with
  129.        help screens for entering survey line data for that  type  of  plat,
  130.        and  the  program  will  accept eighteen characters interpreting the
  131.        characters as follows:
  132.  
  133.        Digits  Program Will Receive     And Interpret It As
  134.        ------  --------------------     -------------------
  135.          1     N, S, or D               The first direction
  136.         2&3    Any number, 0-9          Angular Degrees
  137.         3&4    Any number, 0-9          Angular Minutes
  138.         5&6    Any number, 0-9          Angular Seconds
  139.          7     E or W                   Deflection from first direction
  140.         8-18   Any number, 0-9          Distance in feet
  141.                or period(decimal)
  142.  
  143.  
  144.  
  145.            "N" commands the program to accept eighteen characters and  will
  146.       interpret them as follows:
  147.  
  148.        Digits  Program Will Receive     And Interpret It As
  149.        ------  --------------------     -------------------
  150.          1     N, S, or D               The first direction
  151.                                         (D is the flag informs the program
  152.                                         that there are no more entries)
  153.         2&3    Any number, 0-9          Angular Degrees
  154.         3&4    Any number, 0-9          Angular Minutes
  155.          5     E or W                   Deflection from first direction
  156.         6-18   Any number, 0-9          Distance in feet
  157.                or period(decimal)
  158.  
  159.            All  the arrow keys are active.   The delete key will erase  the
  160.       character  at  the  cursor  position and the cursor  will  remain  in
  161.       position.   The  backspace  key  will erase as it  moves  the  cursor
  162.       backwards.  The return key functions as the down arrow except when it
  163.       is in the last cell;  when pressed in the last cell,  the survey line
  164.       is entered and the screen clears to receive another survey line.   F9
  165.       may  also be used to enter a survey line and clear the screen  for  a
  166.       new line.  F10 clears the screen but does not enter the survey line.
  167.  
  168.            Leading zeroes are not necessary.  Cells for degrees, minutes,
  169.       and seconds will hold two digits.  [2 ], [ 2], and [02] would all be
  170.       received into the program as "2".  When a second digit is entered,
  171.       the cursor moves down to the next cell.
  172.  
  173. ~
  174.  
  175.  
  176.            On the screen  where  courses  and  distances  are  entered  are
  177.       help  screens.     Please  use them and read  them  carefully   until
  178.       fully  familiar with procedures.   The function keys are used to pull
  179.       up help screens.
  180.  
  181.                                Initial Calculations
  182.  
  183.             When  all  survey  lines  are  entered,  type and enter "D".  A
  184.       screen will appear as follows:
  185.       ---------------------------------------------------------------------
  186. ~~
  187.  
  188.         Results of Plat Checking
  189.  
  190.              The easting error is ________.
  191.              The northing error is ________.
  192.              The gap in closure is ________.
  193.              The precision of the field survey is ______ per 10,000
  194.              The acreage computed to the _______ acres.
  195.  
  196.                   (1) Printed Copy
  197.                   (2) Screen Display
  198.                   (3) Return to Menu
  199. ~~~
  200.       ---------------------------------------------------------------------
  201.  
  202.  
  203.            Easting Error:  The distance in feet on the east-west axis  that
  204.       the  plat  fails to close when all survey lines have been entered.  A
  205.       negative value means that the point of ending is west of the point of
  206.       beginning; conversely, a positive value mean the ending point is east
  207.       of the point of beginning.
  208.  
  209.            Northing Error:  The distance in feet on  the  north-south  axis
  210.       that the plat fails to close.  A negative value means that the ending
  211.       point  is  south of the beginning point;  a positive value means that
  212.       the ending point is north of the beginning point.
  213.  
  214.            Gap in Closure:  The distance in feet separating  the  beginning
  215.       point  and ending point.  It is the hypotenuse of the triangle formed
  216.       by the easting and northing errors.
  217.  
  218.            Precision  of  Field  Survey:  The  amount  of  gap  in  closure
  219.       expressed as feet per 10,000 feet.
  220.  
  221.            Acreage:  The  area  enclosed  in  the survey expressed as acres
  222.       (43,560 square feet).
  223. ~
  224.            Menu Selections:
  225.  
  226.               (1) Printed Copy:  This  selection  will  cause  all  entered
  227.               survey lines to be printed.
  228.  
  229.               (2) Screen Display: All survey lines will be displayed on the
  230.               screen.
  231.  
  232.               (3) File Plat Data: Option to file at this point.
  233.  
  234.               (4) Return to Menu:  Returns to main menu and does  not  save
  235.               data inputs.
  236.  
  237.            (1)  and  (2) above will allow the operator to check his entries
  238.       against the plat for accuracy.  After the lines are  printed  or  the
  239.       display  is  exited,   an  opporturnity  will  be  given  for  making
  240.       corrections,insertions,  and deletions.   Experience with the program
  241.       will  teach which  selection is  best  in  certain  situations.   For
  242.       example,    if  the  operator is reasonably sure that  there  are  no
  243.       errors,  he may want to go ahead and produce a hardcopy.  Selection 3
  244.       allows  the  user  to file his plat data at this point.   It  is  not
  245.       necessary  to  save  at this point because PLATCHEK  will  offer  the
  246.       opportunity to save again after the plat is drawn.
  247.  
  248.  
  249.                             Corrections and Insertions
  250.  
  251.            After the survey line inputs are displayed, the next screen will
  252.       produce the menu:
  253.       ---------------------------------------------------------------------
  254.  
  255. ~~
  256.                               CORRECTION OPTIONS
  257.           A.  Correct a Line                      B.  Insert  a Line
  258.           C.  Delete  a Line                      D.  Examine survey lines
  259.           E.  Draw Plat
  260.                               Select:
  261. ~~~
  262.  
  263.       ---------------------------------------------------------------------
  264.  
  265.            If  "A"  is entered,  the next prompt will ask for the number of
  266.       the survey line (the program will number all lines and  display  that
  267.       number  when  it displays the lines).  The line with that number will
  268.       be displayed and an opportunity given  to  correct  it.  The  program
  269.       will continue asking for errors until the reply "0" is received.
  270.  
  271. ~
  272.            "B"   produces the opportunity to insert a line in the  list  of
  273.       survey lines if perchance the operator missed one during input.
  274.  
  275.            "C" produces the opportunity to delete a line.
  276.  
  277.            "D"  produces the "RESULTS OF PLAT CHECKING" screen shown above,
  278.       which  shows  the  calculations after the  corrections,   insertions,
  279.       and/or deletions have been made.
  280.  
  281.            "E" Produces the following screen:
  282.       ---------------------------------------------------------------------
  283. ~~
  284.            (1)  Printed Copy
  285.            (2)  Screen Display
  286.            (3)  Return to Menu
  287. ~~~
  288.       ---------------------------------------------------------------------
  289.  
  290.  
  291.       (1)  A computer drawing of the plat will appear on the monitor.   The
  292.       drawing  will be of no particular scale,   but will be the scale that
  293.       will  produce  the largest size that can be displayed on the  screen.
  294.       The  drawing  will be oriented on a  north-south axis  and   a  north
  295.       arrow  will appear.   Any gap in closure will be graphically   shown.
  296.       Plats  with  large   errors  may  not  be fully  represented  on  the
  297.       screen  because of the closure errors.   If  such  a   case   occurs,
  298.       survey    lines  should  be  rechecked,   especially  for  clock-wise
  299.       orientation.  A  printed copy of the computer  generated  sketch  can
  300.       be  obtained   by  holding  the  shift  key down while  pressing  the
  301.       "PrtSc"(Print Screen)  key.   This will cause  the  contents  of  the
  302.       screen  to  be  printed.   Pressing any other key  will  advance  the
  303.       program   to the next screen without printing the computer  generated
  304.       sketch.  The computer must be in the  GRAPHICS  mode for the graphics
  305.       screen to be printed.  The next screen asks the operator to designate
  306.       a  scale  to have  a  sketch  drawn.   If a scale is named too  small
  307.       for  the  sketch to be printed on the printer paper,    the  operator
  308.       will  be advised and asked to select a larger scale.  (A scale of one
  309.       inch  equal  500  feet is considered larger than a scale of one  inch
  310.       equals 100  feet).   PLATCHEK uses either wide or narrow paper.   The
  311.       operator  advises  PLATCHEK  through the  (P),   "Managing  Printer",
  312.       Selection on the Master Menu.  PLATCHEK allows smaller scales when it
  313.       is advised that wide paper is in use.   When the scale  is  selected,
  314.       the  printer  will   produce   a matrix of characters selected by the
  315.       user which when connected will be a sketch to  scale  of the  subject
  316.       plat.   The computer generated sketch will be helpful  in  connecting
  317.       the dots properly.
  318. ~
  319.       (2)   If a screen display only is chosen,  a  sketch will be drawn on
  320.       the monitor, but no scaled printout will be produced.
  321.  
  322.       (3)    Return the program to the Master Menu but allows the  user  to
  323.       save the plat data if desired.
  324.  
  325.  
  326.                                Saving Plats on File
  327.  
  328.  
  329.            Before  PLATCHEK  returns  to the main menu,  it will ask if the
  330.       plat should be filed.  If the answer is affirmative, then a name will
  331.       be asked for the plat file.  Eight characters will  be  allowed.  The
  332.       program will supply the suffix, .PLT.  The plat as named will then be
  333.       saved  on the diskette or in the directory which contains the program
  334.       file.
  335.  
  336.  
  337.  
  338.  
  339.                                   MANAGING FILES
  340.  
  341.            When this option is selected the following menu will appear:
  342.  
  343.       --------------------------------------------------------------------
  344.  
  345. ~~
  346.                 1.  Complete, Correct, or Run a Filed Plat
  347.                 2.  Erase a File
  348.                 3.  List Plat Files
  349.                 4.  Return to Main Menu
  350.  
  351. ~~~
  352.       --------------------------------------------------------------------
  353.  
  354.            1.  Complete,  Correct,  or Run a Filed Plat:  PLATCHEK will ask
  355.       for  the name of the plat file.  When this is entered,  the plat file
  356.       will be loaded into memory.  The program will move to the  screen  on
  357.       which survey lines  are entered displaying the survey line leading to
  358.       the northernmost point.  From that point the program operates exactly
  359.       as  it did under the BEGIN NEW PLAT menu option.   New lines  entered
  360.       will  be added to those already in memory.   If the plat is  recalled
  361.       only  to make a drawing or for some other use,  the  operator  should
  362.       enter  "D",   and the entry of survey lines will be entered  and  the
  363.       program move to the next step.
  364.  
  365. ~
  366.                          Some reasons to save plats
  367.  
  368.            (a)  Finish  the Input of A Plat:  If the operator is entering a
  369.            lengthy plat and does not have the time to complete the plat  at
  370.            one  sitting,  the operator may enter "D" to inform the computer
  371.            that no more information will be forthcoming.  There is no  need
  372.            to  print the plat as it is incomplete and the printout would be
  373.            misleading,  but the operator should respond in the  affirmative
  374.            when asked whether the plat should be saved.  The operator would
  375.            then  enter the appropriate name for the partial plat.  When the
  376.            operator returned to complete the plat,  he or she  would  press
  377.            "M" for "Manage Files".  Next the program would ask for the name
  378.            of the plat file.  The operator would enter the appropriate name
  379.            and   proceed   with  courses  and  distances  where  left  off.
  380.            IMPORTANT: When the operator wishes to stop and then continue to
  381.            input plat data later,  he(she) should always  begin  the  input
  382.            data  with  the  line leading from the northernmost point on the
  383.            plat.  The program reorients the input data to  begin  with  the
  384.            northernmost  point  before platting or saving as a file occurs;
  385.            therefore, the survey lines would begin and end with a different
  386.            line when the file was recalled than was input by  the  operator
  387.            unless  the  operator began with the northernmost point.  If the
  388.            entire plat data is to be entered at one sitting,  it  does  not
  389.            matter which line is entered first.
  390.  
  391.            (b)  Correct a Plat:  After a plat has been entered,  it may not
  392.            close as accurately as required.  The operator may then save the
  393.            plat and reexamine it for errors.  If  there  appears  to  be  a
  394.            serious  error  in  the  plat  the  user  could consult with the
  395.            surveyor.   Once  the  error  was  found,  the  line  could   be
  396.            changed  as with a new plat.  It may be useful to save all plats
  397.            for a period of time until it is known that there is no  further
  398.            use for them.
  399.  
  400.            2.  Erase a Plat:  The program will ask for the name of the plat
  401.       file to be erased (prefix only,  up to eight  characters).  When  the
  402.       name is entered, the file will be erased.
  403.  
  404.            3.  List Plat Files: The program will list all plat files in the
  405.       directory or on the diskette.
  406.  
  407. ~
  408.  
  409.                                 MANAGING PRINTERS
  410.  
  411.            There   should   be   a  file  on  your  installation  diskette,
  412.       PRINTER.DTA, which contains commands for printer operation.  If there
  413.       is no file on the diskette,  the program will create one for you.  If
  414.       the program is started in the absence of a PRINTER.DTA file,  it will
  415.       advise the operator that there is no file in the  directory  and  ask
  416.       permission  to  create  one.  The  initial  file will contain command
  417.       paramaters used by several IBM compatible printers.
  418.  
  419.            These  printer  commands  can  be  changed as needed to adapt to
  420.       different printers by pressing the  menu  selection  (P)  for  Manage
  421.       Printers.  A  list  of  the  printer commands required by the program
  422.       will be displayed on the screen along with the  current  commands  on
  423.       file  (which  are given to the computer when the program is entered).
  424.       Any or all of these commands can  be  changed.  The  operator  should
  425.       consult  the  manual  of  his  printer  for the commands necessary to
  426.       control the printer in use.
  427.  
  428.                           REORIENTATION OF SURVEYLINES
  429.  
  430.           PLATCHEK reorients all survey lines after "D"  is  entered.  They
  431.       are reoriented in such a way that the line leading from the northern-
  432.       most point is placed first and all other lines follow ending with the
  433.       line  leading  to  the  northernmost  point.  This  reorientation  is
  434.       necessary in order for the program to produce the scaled plat on  the
  435.       dot  matrix printers whose carriages only move in one direction.  The
  436.       gap,  if there is one, is  thus  located  at the northernmost  point.
  437.  
  438.                             UNDERSTANDING PLAT ERRORS
  439.  
  440.            This program computes mathematically the area within  a  polygon
  441.       no  matter  the number of sides (up to the limit of the program).  It
  442.       uses  the  distance  and  direction  of  these  sides  to  make   the
  443.       computations.  Plats are not always true polygons;  that is,  they do
  444.       not always close.  If a rectangle did not close,  the product of  its
  445.       length  and  width would only be an estimate of the area it enclosed,
  446.       the greater the gap in closure the less accurate the estimate.
  447.  
  448.            As plat error (measured as gap in closure  per  unit  length  of
  449.       traverse)   increases   the   reliability   of  acreage  computations
  450.       decreases.  Modern day surveyors strive for less than one foot  error
  451.       per 10,000 feet of survey.  Many plats, especially older ones, do not
  452.       close  within  these  tolerances,  but  still are accurate enough for
  453.       checking with this program.  However,  it is important  to  keep  the
  454.       fact  in  mind  that  the  reliability of acreage computations varies
  455.       directly with closure error.
  456. ~
  457.  
  458.                                   PRINTER MODES
  459.  
  460.            Several options are available to  the  operator  in  customizing
  461.       PLATCHEK to a particular printer.
  462.  
  463.            Scale  Printout:  PLATCHEK  is programmed to use the command for
  464.            compressed print to set the  printer  for  the  scaled,  printed
  465.            matrix.    (Although the characters are printed in normal  size,
  466.            the  spaces  are compressed to achieve greater accuracy given  a
  467.            space limiataiton.)
  468.  
  469.                                   SIZE OF PLATS
  470.  
  471.            Plat  lines  are entered into a linked list(dynamic  variables).
  472.      Therefore, the limitation as to the size of plat depends on the random
  473.      access memory of individual CPUs.  It is not believed that the user is
  474.      likely  to  encounter a plat that goes beyond the limit  of  even  the
  475.      smaller RAMs of modern IBM and compatible computers.
  476.  
  477.  
  478.                                  PLATS WITH ARCS
  479.  
  480.            PLATCHEK Version 1.7 does not handle circular lines (arcs), only
  481.      straight lines (although the next version will possibly  also  compute
  482.      and  plot  plats  with  arcs).  On  the  distribution  diskette  is an
  483.      executable file, ARC.COM,  which will calculate the area within a seg-
  484.      ment  of  a  circle  described  by an arc.  ARC.COM is completely menu
  485.      driven.  Many plats will give the distance in feet of the arc  and  of
  486.      the  chord (straight line that connects to the two ends of the arc and
  487.      which with the arc encloses the segment of a circle).  ARC.COM prompts
  488.      for these two values and from them computes the acreage within the arc
  489.      in both square units of arc and chord measure (usually feet).  A value
  490.      is also given in acres which is accurate if lengths are in feet.
  491.  
  492.           If the arc length and the length of the radius of the circle  are
  493.      given,  the user may enter these data and obtain the same results much
  494.      more  quickly.   Similarly,  if the chord length and radius are  known
  495.      rapid calculations can be made.
  496.  
  497.           In the operation of PLATCHEK the user can only enter the straight
  498.      line distance (chord) and direction as shown on the  plat.  That  line
  499.      segment  is the chord of the arc.  In effect the arc must be flattened
  500.      to a straight line to be run on PLATCHEK.  Thus,  the acreage  between
  501.      the  segment  of  the  circle  curvature  (arc)  and the straight line
  502.      (chord)  is  not  included  in  the  area  calculations.   By   visual
  503.      inspection  of the plat the user can determine whether to add the area
  504.      to or subtract the area from the area computed by PLATCHEK.
  505. ~
  506.  
  507.  
  508.                                LINE TO CLOSE PLAT
  509.  
  510.           One of the new features that came with version 1.7 was the option
  511.      to compute  a line that would close a plat from the point of  the last
  512.      survey  line entered.   Pressing F7  during the input of survey  lines
  513.      will produce the course and distance of a line which would connect the
  514.      beginning point of the first line entered and  the ending point of the
  515.      last line entered.
  516.  
  517.  
  518.                                    HELP MENUS
  519.  
  520.           Version  1.7  also introduced help screens to the  entry  screen.
  521.      Using the function keys the operator can obtain information during the
  522.      actual input of survey data.   On-screen information is believed to be
  523.      self-explanatory.
  524.